package cn.iocoder.yudao.module.system.service.area;

import java.util.*;
import cn.iocoder.yudao.module.system.controller.admin.area.vo.*;
import cn.iocoder.yudao.module.system.dal.dataobject.area.AreaDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

import javax.validation.Valid;

/**
 * 地区 Service 接口
 *
 * @author 吕小文
 */
public interface AreaService {

    /**
     * 获取地区
     * @param pid 父编号
     * @return 结果
     */
    List<AreaDO> getAreaList(String pid);

    /**
     * 创建地区
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    String createArea(@Valid AreaSaveReqVO createReqVO);

    /**
     * 更新地区
     *
     * @param updateReqVO 更新信息
     */
    void updateArea(@Valid AreaSaveReqVO updateReqVO);

    /**
     * 删除地区
     *
     * @param id 编号
     */
    void deleteArea(String id);

    /**
     * 获得地区
     *
     * @param id 编号
     * @return 地区
     */
    AreaDO getArea(String id);

    /**
     * 获得地区分页
     *
     * @param pageReqVO 分页查询
     * @return 地区分页
     */
    PageResult<AreaDO> getAreaPage(AreaPageReqVO pageReqVO);

    /**
     * 刷新地区缓存
     */
    void refreshArea();
}